Correct misleading docs. Add docs for the "activate" signal. (#129358,

Thu Dec 18 01:37:59 2003  Matthias Clasen  <maclas@gmx.de>

	* gtk/gtkwidget.c (gtk_widget_activate): Correct misleading docs.
	* gtk/gtkbutton.c (gtk_button_class_init): Add docs for the
	"activate" signal.  (#129358, Ka-Hing Cheung)

diff --git a/ChangeLog b/ChangeLog
index 52ce513608f0264a862cd970fdf4669e7c81fbbf..d3f2a17ce503005da8b12073ebdb3bdc677016fa 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+Thu Dec 18 01:37:59 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtkwidget.c (gtk_widget_activate): Correct misleading docs.
+       * gtk/gtkbutton.c (gtk_button_class_init): Add docs for the 
+       "activate" signal.  (#129358, Ka-Hing Cheung)
+
 Thu Dec 18 01:21:59 2003  Kristian Rietveld  <kris@gtk.org>
 
        * gtk/gtktreeview.c (gtk_tree_view_class_init): Jonathan got

diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index 52ce513608f0264a862cd970fdf4669e7c81fbbf..d3f2a17ce503005da8b12073ebdb3bdc677016fa 100644 (file)
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,3 +1,9 @@
+Thu Dec 18 01:37:59 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtkwidget.c (gtk_widget_activate): Correct misleading docs.
+       * gtk/gtkbutton.c (gtk_button_class_init): Add docs for the 
+       "activate" signal.  (#129358, Ka-Hing Cheung)
+
 Thu Dec 18 01:21:59 2003  Kristian Rietveld  <kris@gtk.org>
 
        * gtk/gtktreeview.c (gtk_tree_view_class_init): Jonathan got

diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4
index 52ce513608f0264a862cd970fdf4669e7c81fbbf..d3f2a17ce503005da8b12073ebdb3bdc677016fa 100644 (file)
--- a/ChangeLog.pre-2-4
+++ b/ChangeLog.pre-2-4
@@ -1,3 +1,9 @@
+Thu Dec 18 01:37:59 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtkwidget.c (gtk_widget_activate): Correct misleading docs.
+       * gtk/gtkbutton.c (gtk_button_class_init): Add docs for the 
+       "activate" signal.  (#129358, Ka-Hing Cheung)
+
 Thu Dec 18 01:21:59 2003  Kristian Rietveld  <kris@gtk.org>
 
        * gtk/gtktreeview.c (gtk_tree_view_class_init): Jonathan got

diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6
index 52ce513608f0264a862cd970fdf4669e7c81fbbf..d3f2a17ce503005da8b12073ebdb3bdc677016fa 100644 (file)
--- a/ChangeLog.pre-2-6
+++ b/ChangeLog.pre-2-6
@@ -1,3 +1,9 @@
+Thu Dec 18 01:37:59 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtkwidget.c (gtk_widget_activate): Correct misleading docs.
+       * gtk/gtkbutton.c (gtk_button_class_init): Add docs for the 
+       "activate" signal.  (#129358, Ka-Hing Cheung)
+
 Thu Dec 18 01:21:59 2003  Kristian Rietveld  <kris@gtk.org>
 
        * gtk/gtktreeview.c (gtk_tree_view_class_init): Jonathan got

diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8
index 52ce513608f0264a862cd970fdf4669e7c81fbbf..d3f2a17ce503005da8b12073ebdb3bdc677016fa 100644 (file)
--- a/ChangeLog.pre-2-8
+++ b/ChangeLog.pre-2-8
@@ -1,3 +1,9 @@
+Thu Dec 18 01:37:59 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtkwidget.c (gtk_widget_activate): Correct misleading docs.
+       * gtk/gtkbutton.c (gtk_button_class_init): Add docs for the 
+       "activate" signal.  (#129358, Ka-Hing Cheung)
+
 Thu Dec 18 01:21:59 2003  Kristian Rietveld  <kris@gtk.org>
 
        * gtk/gtktreeview.c (gtk_tree_view_class_init): Jonathan got

diff --git a/gtk/gtkbutton.c b/gtk/gtkbutton.c
index 6a7269f5efa61f1bca1edf6d29e5a49704825b57..d543e3608895bbc2f27b3002b6eb945304e2283b 100644 (file)
--- a/gtk/gtkbutton.c
+++ b/gtk/gtkbutton.c
@@ -316,6 +316,15 @@ gtk_button_class_init (GtkButtonClass *klass)
                  NULL, NULL,
                  _gtk_marshal_VOID__VOID,
                  G_TYPE_NONE, 0);
+
+  /**
+   * GtkButton::activate:
+   *
+   * The "activate" signal on GtkButton is an action signal and
+   * emitting it causes the button to animate press then release. 
+   * Applications should never connect to this signal, but use the
+   * "clicked" signal.
+   */
   button_signals[ACTIVATE] =
     g_signal_new ("activate",
                  G_OBJECT_CLASS_TYPE (object_class),

diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 9c66beccc57d6cee8450068387afe47733e0c84f..b6d45ea85fbbffa5bc11869e26eda7e448cb4898 100644 (file)
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -3557,9 +3557,8 @@ gtk_widget_event_internal (GtkWidget *widget,
  * 
  * For widgets that can be "activated" (buttons, menu items, etc.)
  * this function activates them. Activation is what happens when you
- * press Enter on a widget during key navigation; clicking a button,
- * selecting a menu item, etc. If @widget isn't activatable,
- * the function returns %FALSE.
+ * press Enter on a widget during key navigation. If @widget isn't 
+ * activatable, the function returns %FALSE.
  * 
  * Return value: %TRUE if the widget was activatable
  **/